home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat4 / dmedia / bicsf.z / bicsf
Encoding:
Text File  |  1998-10-20  |  6.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. bbbbiiiiccccssssffff((((4444))))                                                              bbbbiiiiccccssssffff((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      BICSF, IRCAM - Berkeley/IRCAM/CARL Sound File Format
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiiooooffffiiiilllleeee....hhhh>>>>
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The Audio File Library currently supports 13 of the commonly found audio
  16.      file formats, i.e., is able to recognize, read, and write sample data and
  17.      header information to and from files in these formats.  It is important
  18.      not to confuse _s_a_m_p_l_e or _a_u_d_i_o _d_a_t_a _f_o_r_m_a_t_s with _f_i_l_e _f_o_r_m_a_t_s.  The
  19.      former refers to the bit-wise organization of the sound samples in the
  20.      file, i.e., whether the format is 8-bit integer or 16-bit unsigned, etc.
  21.      Audio file format refers to the structure of the _a_u_d_i_o _f_i_l_e _h_e_a_d_e_r, the
  22.      chunk of on-disk data which preceeds the samples and which provides
  23.      information about the file to the audio program.  A single audio file
  24.      format may support a large variety of sample formats.
  25.  
  26.      The BBBBeeeerrrrkkkkeeeelllleeeeyyyy////IIIIRRRRCCCCAAAAMMMM////CCCCAAAARRRRLLLL SSSSoooouuuunnnndddd FFFFiiiilllleeee FFFFoooorrrrmmmmaaaatttt ((((bbbbiiiiccccssssffff)))) was developed during
  27.      the 1980's and represented the merging of several earlier header formats.
  28.      It is used extensively in academic computer music centers, and is the
  29.      default file format for several sound synthesis packages such as MIT's
  30.      Csound.  It consists of a fixed-length header of 1024 bytes.  The first
  31.      17 bytes are reserved for sample format information;  the remainder is
  32.      used for optional "sfcodes" which provide additional information such as
  33.      maximum amplitude, creation date, or a text comment.
  34.  
  35. DDDDAAAATTTTAAAA FFFFOOOORRRRMMMMAAAATTTT SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNNSSSS
  36.      SSSSaaaammmmpppplllleeee FFFFoooorrrrmmmmaaaattttssss::::
  37.           Two's complement integer and 32-bit single-precision floating point
  38.           only.
  39.  
  40.      SSSSaaaammmmpppplllleeee WWWWiiiiddddtttthhhhssss::::
  41.           For integer:  16 bit only;  floating points are always 32 bit.
  42.  
  43.      BBBByyyytttteeee OOOOrrrrddddeeeerrrrssss::::
  44.           Only bigendian currently supported for writing;  littleendian files,
  45.           generated on DEC Alpha machines and some other platforms, are
  46.           writable and readable.
  47.  
  48.      CCCChhhhaaaannnnnnnneeeellll CCCCoooouuuunnnnttttssss::::
  49.           1, 2, and 4  channels only.
  50.  
  51.      CCCCoooommmmpppprrrreeeessssssssiiiioooonnnn FFFFoooorrrrmmmmaaaattttssss::::
  52.           None supported, and none in common usage.
  53.  
  54. FFFFIIIILLLLEEEE FFFFOOOORRRRMMMMAAAATTTT SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNNSSSS
  55.      BICSF files can contain additional chunks of data.  Most of these are
  56.      parsed by the AF and made available:
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. bbbbiiiiccccssssffff((((4444))))                                                              bbbbiiiiccccssssffff((((4444))))
  71.  
  72.  
  73.  
  74.      IIIInnnnssssttttrrrruuuummmmeeeennnntttt CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnnssss::::
  75.           None allowed.
  76.  
  77.      MMMMaaaarrrrkkkkeeeerrrrssss::::
  78.           None allowed.
  79.  
  80.      MMMMiiiisssscccceeeellllllllaaaannnneeeeoooouuuussss CCCChhhhuuuunnnnkkkkssss::::
  81.               AAAAFFFF____MMMMIIIISSSSCCCC____IIIIRRRRCCCCAAAAMMMM____PPPPEEEEAAAAKKKKAAAAMMMMPPPP    peak amplitude sfcode (see _C_A_V_E_A_T_S)
  82.  
  83.               AAAAFFFF____MMMMIIIISSSSCCCC____CCCCOOOOMMMMMMMMEEEENNNNTTTT    text comment
  84.  
  85. CCCCAAAAVVVVEEEEAAAATTTTSSSS
  86.      The miscellaneous chunk AAAAFFFF____MMMMIIIISSSSCCCC____IIIIRRRRCCCCAAAAMMMM____PPPPEEEEAAAAKKKKAAAAMMMMPPPP is always 36 bytes and
  87.      contains a fixed "sfcode" structure:
  88.  
  89.      ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt ____ssssffffmmmmaaaaxxxxaaaammmmpppp {{{{
  90.           ffffllllooooaaaatttt   vvvvaaaalllluuuueeee[[[[4444]]]];;;;
  91.           iiiinnnntttt    ssssaaaammmmpppplllloooocccc[[[[4444]]]];;;;
  92.           iiiinnnntttt    ttttiiiimmmmeeeettttaaaagggg;;;;
  93.      }}}} SSSSffffMMMMaaaaxxxxaaaammmmpppp;;;;
  94.  
  95.      Care must be taken when using aaaaffffWWWWrrrriiiitttteeeeMMMMiiiisssscccc(3dm) to provide the correct
  96.      number of bytes of data, or the result will be unreadable.
  97.  
  98.      The miscellaneous chunk AAAAFFFF____MMMMIIIISSSSCCCC____CCCCOOOOMMMMMMMMEEEENNNNTTTT has a maximum size of 512 bytes,
  99.      and will always be allocated out to 256 bytes.  This does not affect the
  100.      size of the BICSF file header.  This chunk was formerly known as
  101.      AF_MISC_IRCAM_COMMENT and can still be referred to as this, for backwards
  102.      compatibility.
  103.  
  104. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  105.      afInitFileFormat(3dm), afGetFileFormat(3dm), afIntro(3dm)
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.